--------------------------------------------------------------------------------
 mp3stuff v0.9939 by Andy Dufilie (^Andy) February 24th 2001 11:55pm
--------------------------------------------------------------------------------
 homepage:  http://come.to/andys.site/  or  http://pages.cthome.net/pdufilie/
   check out these other addons by me:  Tanks, bmp2html, ^Andy's Dialog Editor
 please report any bugs, and send comments and suggestions to:  a_s_d@snet.net
--------------------------------------------------------------------------------
 this is an addon made for mIRC32 v5.7+
 to install:
   files needed:  mp3stuff.mrc and mp3stuf1.mrc
   move all mp3stuff files to the same directory
   type the following in a mIRC window:  /load -rs mp3stuff.mrc
   (if they are in a directory other than your mIRC directory, specify it)

   when a window pops up asking if you want to
   run initialization commands, click on 'yes'
--------------------------------------------------------------------------------

 ================
  newest changes
 ================
   - added option in popup to display channel ad once.
  v0.9939
   - changed auto-install to NSIS.
   - auto-install works properly in windows 2000 now
  v0.9938
   - fixed bug when searching for files (auto-send/@locator)
  v0.9937
   - sped up @locator/@find by searching a cached list instead of hard drives
   - fixed some bugs in playlist editor
   - fixed another Windows 2000 bug :)
  v0.9936
   - fixed file selecting dialog and file info bugs
   - added "edit mp3 directories" option to /mp3search popup menu (it opens the
     options dialog to the tab with mp3 directories).
  v0.9935
   - fixed "* /if: 'b' unknown operator" bug
  v0.9934
   - fixed bugs with Windows 2000
  v0.9933
   - fixed bugs (froze mIRC 5.7 & 5.71)
  v0.9932
   - stuffamp is now included (you can only use it in mIRC 5.8+).  popups for
     stuffamp are under "mp3stuff > more options"
   - fixed bug in file & directory selecting dialogs
   - fixed channel ad not starting on startup
   - added option in popup menu to advertise mp3stuff to active channel/query
  v0.9931
   - fixed bug, list maker wasn't working in mirc 5.8+
  v0.993
   - fixed bugs with presets
   - fixed/changed some small things
  v0.9929
   - when adding files from an .m3u into the playlist editor, if the .m3u does
     not contain the full directory info for a playlist entry (winamp sometimes
     makes .m3u files like this), the directory of the .m3u will be added at
     the beginning of the entry.
   - (important) fixed bug with slots that made it possible for people to use
     up more slots than you wanted.
   - fixed small bug in list maker, only did first directory in mirc 5.8
  v0.9928
   - fixed some small bugs and made some improvements
   - made some adjustments to dialogs
  v0.9927
   - @locator/@find note can now use the same tags as the timed channel ad can.
   - added option to change color for </c> tags in echos.
   - made options dialog bigger.
   - made playlist editor bigger.
   - improved a lot of code; options dialog is faster & closes instantly.
  v0.9926
   - argh.  fixed bug in install.
  v0.9925
   - added buttons that let you change the number of minutes to wait between
     custom channel advertisements.
   - made the mp3 & directory selecting dialogs save the drive letters for the
     drop-down menu, so it won't scan for them each time you open it (it opens
     faster now in some situations).
   - for the mp3 & directory selecting dialogs, added a "refresh" option in the
     drop-down menu to refresh the current directory and rescan for drive
     letters.
   - edit boxes in the options dialog now take effect immediately, like
     everything else there.
   - renamed 'ok' button in options dialog to 'close'
   - renamed 'done' button in playlist editor to 'save & close'
   - fixed bug in list maker (didn't work in 5.7)
  v0.9924
   - changed colors for file serving messages, now uses color 15, background 1
     instead of your default normal/background colors.  Your specified random
     colors will now be used in file serving messages, excluding 15 and 1.
     If no other colors are specified or random colors are disabled, color 14
     will be used instead of a random color.
   - added documentation for more aliases
   - fixed pr and pc commands, the [#|nick] parameter was required. now it is
     optional.
   - fixed some echo related stuff
  v0.9923
   - fixed bug in listening echo
  v0.9922
   - split the 'display' tab of the options dialog into two tabs,
     'local display' and 'public display'
   - added option to change other echos ('bullet for other echos')
   - added option for custom 10-minute timed channel advertisement.
   - fixed mute again.  it wouldn't let you play to channels when it was on.
  v0.9921
   - added <mp3noext> tag for the filename without the .mp3 file extension.
   - added <list count> and <list size> tags, for number of mp3s in your list
     and the size of those mp3s.
   - put an edit box (instead of text) on the display tab of the options dialog
     with a list of supported tags, so you can now copy and paste from there.
   - fixed (interesting) bug in mp3 selecting dialog, gotten after doing
     something such as changing id3 tag of the mp3 you last chose (to change
     file size) or clearing the cache.
   - changed names of mp3stuff files, now they all start with "mp3stuff"
     (except mp3stuf1.mrc) instead of "mp3stuf" + something.
  v0.992
   - fixed bug in file serving.. it was saying it couldn't find the file
     (only happened in mIRC v5.81)
  v0.9919
   - fixed bug, it wouldn't save presets if mp3stuff.pre didn't exist
  v0.9918
   - fixed bug when loading options dialog with presets
     (froze only mIRC v5.81+)
  v0.9917
   - fixed bug in auto install (from v0.9915)
  v0.9916
   - added 'search' and 'cancel' buttons to the mp3 selecting dialog.
     the 'search' button opens "/mp3search *".
  v0.9915
   - re-arranged options dialog (it's a lot bigger)
   - added controls to save/recall/remove custom colors, echos, and messages
   - changed variables for colors, listening echo and play message
     (your old ones are in %mp3stuffrc, %mp3stuffle and %mp3stuffmsg)
   - added <mp3count> tag
   - fixed bug with listening echo (really this time) and others
  v0.9914
   - fixed bug: things weren't displaying properly when no colors were
     specified
   - fixed bug: <c> tags were always returning random colors in play message
  v0.9913
   - renamed <r> and </r> tags to <c> and </c>.
   - added support for a more customizable listening echo.
  v0.9912
   - fixed a bug which was causing a slow startup.
  v0.9911
   - fixed a problem with random colors going to color 0 when only your normal
     and background colors were in the list.
   - 'all colors' button renamed to 'default'
   - 'default' random colors now include all _but_ normal and background colors
     (instead of all). you can now get your current normal and background
     colors from random, you just have to add them in to the list in the
     'display' tab of the options dialog.
   - added support for these tags in custom play message:
       <open slots> <used slots> <slots> <open queues> <used queues> <queues>
   - fixed bug where remote control would be activated when a new song starts
  v0.991
   - fixed some bugs with options dialog, cleaned up a lot of code
   - new popups for playing to all
   - if you are in no channels and play to 'all,' it will play to all queries.
  v0.9909
   - fixed some bugs, made some adjustments..
   - re-arranged some stuff in the 'display' tab of the options dialog
   - added option to specify random play message colors (under 'display')
  v0.9908
   - enter "all" into the 'play to' edit box in the remote control or the mp3
     selecting dialog, and it will play to all channels.
  v0.9907
   - new option for a custom play message (in 'display' tab of options dialog)
  v0.9906
   - fixed problems with remote control not saving settings
   - fixed infinite loop, and some other things with the playlist editor
   - fixed mute bug
  v0.9905
   - re-arranged playlist editor & added a 'done' button
   - new documentation of play aliases in help file
  v0.9904
   - added 'add m3u' and 'save copy' buttons to playlist editor
  v0.9903
   - remote control dialog now saves previous ontop/desktop settings
  v0.9902
   - added checkbox to file select dialog, "dialog re-opens"
   - when adding files to playlist, the file selecting
     dialog now re-opens for another selection.
  v0.9901
   - improved file serving message delay stuff
     (doesn't send messages that were replying to @commands
      done in channels if you're not in that channel anymore)
   - improvements to /mp3search window popup
   - support for mIRC v5.8 mp3 player

--------------------------------------------------------------------------------

 ||
 |  mp3stuff help  |
 |_________________|
   mp3stuff will work with mp3s that have commas, and even double-spaces in
   the file names.  It also supports variable bitrate mp3s.  mp3stuff uses
   mp3 file info caching.  The first time it gets info from an mp3, it will
   save the info for later use.  This makes everything go much faster.  You
   can install mp3stuff from any directory; just put both .mrc files into
   the same directory, and include the path when you install.
   Example:
     Put both .mrc files into c:\mp3\ and type /load -rs c:\mp3\mp3stuff.mrc
     If the directory has a space in it, put quotation marks around the file.
     Example:  /load -rs "c:\m p 3\mp3stuff.mrc"

   mp3stuff also supports Passive DCC send (pasvdcc.mrc) by vague, for sending
   files from behind a firewall or network.  You can get it from this address:
   http://www.guldheden.studenthem.gu.se/~sandin/pasvdcc.mrc

   _____________________________
  |         help topics         |
  |=============================|
  | - popup menu                |
  | - remote control            |
  | - 'Select an mp3' dialog    |
  | - 'Pick a directory' dialog |
  | - options dialog            |
  | - playlist editor           |
  | - /mp3search                |
  | - other commands            |
   


 ============
  popup menu
 ============
   mp3stuff adds popups to the Status Window, Channel, Nicklist, Query, and
   Menubar.  Some popups have "" or "" in the name.  Click on these to hide
   or unhide that group of options.  Popups with "[ ]" or "[]" in front of the
   name act like checkboxes.  Click on them to toggle the option on or off.
   The rest of the choices will open a window or an mp3.

   [ next mp3 ]
     - This appears above the 'mp3stuff' menu when an mp3 is in the play queue,
       or when an mp3 is currently playing and 'continuous play' is enabled.
       If any mp3s are in the play queue, this will play the next mp3 in the
       list.  If the queue is empty, it will select a random mp3 and open it.

   stuffamp
     - This menu appears only if you are using mIRC v5.8+.

   advertise mp3stuff
     - This advertises mp3stuff in the active channel/query window.



 ================
  remote control
 ================
   The remote control is a small dialog that you can keep open for easy playing
   of mp3s.  In the popup, click on  "mp3stuff > open remote control"

     'choose' button
       - Lets you pick an mp3 to open.

     'random' button
       - Opens a random mp3.  If you have the playlist enabled, it will pick
         a random one from the playlist.  If the playlist is disabled, it
         will pick a random one from your mp3 directories.

     continuous play
       - If this box is checked, mp3stuff will play a random mp3 after the
         current one.

     listen
       - If this is selected, there will be no messages sent to channels or
         queries.

     play to
       - This will play to the channel or query specified in the edit box on
         the right. mp3stuff will only play to channels you are currently in
         and query windows that you have open.  Everything else that is entered
         into the edit box is ignored.
         - You can double-click on the radio button to put the active channel or
           query into the edit box.
         - You can enter more than one place to play the mp3 by separating them
           with commas.  Enter "all" into the edit box to play to all channels
           you are currently in.  If you aren't in any channels, 'all' will
           play to all queries.
         - If this radio button is checked, there are no valid channels or
           queries in the edit box, mute is not on, and you try to play an mp3,
           it will switch to listening mode and open the mp3.


     options
     -------
       - These setup options will be shown when the remote control is first
         opened, and hidden when you press the 'ok' button.  They will be
         shown again when you click on the popup to open the remote control.

       on top
         - This sets the remote control on top of other windows when enabled.

       desktop
         - This will open the remote control as a desktop window, and it will
           be shown on the taks bar.

       'listening only' button
         - This will hide the 'play to' controls and display the 'vert' and
           'horiz' options.

       vert
         - This puts the remote control in 'vertical' mode.  It moves the
           'continuous play' checkbox below the 'choose' and 'random' buttons.

       horiz
         - This puts the remote control in 'horizontal' mode.  It moves the
           'continuous play' checkbox to the right of the 'choose' and 'random'
           buttons.

       'ok' button
         - This will hide the remote control setup options.



 ========================
  'Select an mp3' dialog
 ========================
   If you have the 'use mp3stuff dialogs for mp3s' option enabled on the
   first tab of the options dialog, this dialog will pop up when you need to
   pick an mp3.

   current directory
     - The current directory is displayed at the top of the dialog, and the
       contents are below.

   drive letters drop-down menu
     - The drop-down menu in the upper-right corner allows you to browse
       different drives.  Select 'refresh' to refresh the current directory
       and scan for drive letters again.

   directory contents
     - Directories are surrounded by []'s, and mp3s are indented. 
     - Double-click or press enter when you have a directory selected to view
       the contents of it.  Double-clicking on "[..]" will take you to the
       parent directory.
     - Double-click on an mp3 to pick it and close the dialog.  When an mp3 is
       selected, the info for it will be displayed at the bottom of the dialog.

   other options
     - These options will not be displayed when selecting an mp3 to add to the
       playlist.

     listen
       - If this is selected, there will be no messages sent to channels or
         queries.

     play to
       - This will play to the channel or query specified in the edit box on
         the right. mp3stuff will only play to channels you are currently in
         and query windows that you have open.  Everything else that is entered
         into the edit box is ignored.
         - You can double-click on the radio button to put the active channel or
           query into the edit box.
         - You can enter more than one place to play the mp3 by separating them
           with commas.  Enter "all" into the edit box to play to all channels
           you are currently in.  If you aren't in any channels, 'all' will
           play to all queries.
         - If this radio button is checked, there are no valid channels or
           queries in the edit box, mute is not on, and you try to play an mp3,
           it will switch to listening mode and open the mp3.

     'search' button
       - This does the same thing as typing "/mp3search *".  It will open up a
         window with a list of all mp3s in your mp3 directories.

     'cancel' button
       - This will cancel selecting a file. (same as clicking on 'x')

     dialog re-opens
       - If this option is enabled, the dialog will re-open after you select an
         mp3.

     enqueue by default
       - This lets you choose what mp3stuff will do with an mp3 when it is
         ready to be played.  If this option is enabled, then the mp3s will
         be placed in the play queue to be opened in order after the one
         that is currently playing finishes.  Otherwise, mp3s will be opened
         immediately on selection, regardless if one is already playing.



 ===========================
  'Pick a directory' dialog
 ===========================
   If you have the 'use mp3stuff dialogs for directories' option enabled
   on the first tab of the options dialog, this dialog will pop up when you
   need to pick a directory.  This dialog functions much like the 'Select an
   mp3' dialog as explained above.  The differences are that mp3s are not
   displayed, and you pick the current directory by clicking on the button in
   the upper-left corner labeled 'this one:'.



 ================
  options dialog
 ================
   In this dialog, you can configure most of the options available in mp3stuff.
   In the popup, click on  "mp3stuff > more options > options dialog"


   -------------------------------------------------------------------
    first tab of options dialog, labeled "playlist / version / stuff"
   -------------------------------------------------------------------

     playlist options
     ----------------
       - You can create a playlist and have mp3stuff play random mp3s from it.

       use playlist as random mp3 source
         - Enables or disables playlist feature.

       only play each mp3 in playlist once
         - Will not repeat mp3s until entire playlist has been played.

       restart playlist and continue when done
         - When you have 'only play each mp3 in playlist once' enabled, and all
           the mp3s in the playlist have been played, mp3stuff can either stop
           playing or restart the playlist and continue.

       'edit playlist' button
         - This opens the playlist editor, described at the end of this file.


     version checking
     ----------------
       - mp3stuff can automatically check for new versions and install them.

       check for new version
         - Click on this button to check if you have the latest version of
           mp3stuff.

       install newest version
         - Click on this button to download and install the latest version.

       check for new version on startup
         - When this is enabled, mp3stuff will check if you have the latest
           version when you open mIRC.

       install new version when found
         - When a new version is found, this will download and install it
           automatically.

       'about' button
         - Opens a dialog that shows the version number, has a button to send
           me an e-mail, and a button to visit my web page.


     stuff
     -----

       mute
         - This allows you to play mp3s to a channel without listening to them
           yourself.  Mute will be turned off when you click on a popup or
           button to listen to an mp3.

       enqueue by default
         - This lets you choose what mp3stuff will do with an mp3 when it is
           ready to be played.  If this option is enabled, then the mp3s will
           be placed in the play queue to be opened in order after the one
           that is currently playing finishes.  Otherwise, mp3s will be opened
           immediately on selection, regardless if one is already playing.

       listen to others' mp3s
         - When others play mp3s and their script sends an mp3 ctcp, mp3stuff
           will search your mp3 directories for the file and open it.  If the
           mute option is on, this will be disabled.

       allow interruptions
         - This option only matters if listening is enabled and 'enqueue by
           default' is disabled.  If you are currently listening to an mp3 and
           someone plays one to you, the mp3 will either be placed in the play
           queue if this option is disabled, or it will be opened immediately
           (interrupting your current mp3) if this option is enabled.  If
           'enqueue by default' is enabled, then mp3s being played by others
           will always be placed in the play queue to be opened later.


       mp3 file info caching
       ---------------------
         - mp3stuff uses mp3 file info caching.  The first time it gets info
           from an mp3, it will save the info for later use.

         use mp3 file info caching
           - This will enable or disable the mp3 file info caching.

         clear cache
           - This will clear the mp3 file info cache.


       mp3stuff dialogs
       ----------------
         use mp3stuff dialogs for mp3s/directories
           - You can use either the dialogs in mp3stuff or the windows file
             selecting system to choose mp3s and directories.


   -------------------------------------------------------
    second tab of options dialog, labeled "local display"
   -------------------------------------------------------

     colors for <c> tags in echos, separated by commas
     -------------------------------------------------
       - Specify the numbers you want mp3stuff to pick from when choosing
         random colors for <c> tags in echos.

       enable random colors
         - Normally, echos will use the info text color where <c> tags are.
           If this is enabled, it will use random colors instead.

       'save as...' button
         - Saves the current list of colors to a preset with the name you want.

       'presets' drop-down menu
         - Select a color list preset to load into the edit box.

         '[default]' preset
           - This puts all colors except your normal text color and your
             background color into the edit box.

       'remove' drop-down menu
         - Select a color list preset to remove.


     custom listening echo
     ---------------------
       - You can enter a custom listening echo into the edit box.
         This can use all of the tags listed below.

       echo to status instead of active when listening
         - If you don't want mp3stuff echoing to the active window when you are
           listening to mp3s, then check this box.

       'save as...' button
         - Saves the current listening echo to a preset with the name you want.

       'presets' drop-down menu
         - Select a preset to load the listening echo into the edit box.

         '[default]' preset
           - The default listening echo.

       'remove' drop-down menu
         - Select a listening echo preset to remove.


     bullet for other echos
     ----------------------
       - You can enter a bullet for other echos with the edit box.
         <c> and </c> tags will work here.

       'default' button
         - This will put the default bullet into the edit box.


     color for </c> tags in echos
     ----------------------------
       - The '+/-' buttons change the color.
       - The 'default' button puts your normal text color in the edit box.


     supported tags
     --------------
       - This is the same as in the next tab; see below.


   -------------------------------------------------------
    third tab of options dialog, labeled "public display"
   -------------------------------------------------------

     colors for <c> tags in messages, separated by commas
     ----------------------------------------------------
       - Specify the numbers you want mp3stuff to pick from when choosing
         random colors for <c> tags in messages.

       enable random colors
         - This enables/disables <c> tags in messages.

       'save as...' button
         - Saves the current list of colors to a preset with the name you want.

       'presets' drop-down menu
         - Select a color list preset to load into the edit box.

         '[default]' preset
           - This puts all colors except your normal text color and your
             background color into the edit box.

       'remove' drop-down menu
         - Select a color list preset to remove.


     custom play message
     -------------------
       - You can enter a custom play message into the edit box.
         This can use all of the tags listed below.

       send mp3 ctcps when playing
         - This allows others to hear your mp3s if they have an mp3 with the
           same filename and an mp3 script that supports mp3 ctcps.

       echo mp3 ctcps being sent
         - You can have mp3stuff display the mp3 ctcps being sent or not with
           this option.

       'save as...' button
         - Saves the current play message to a preset with the name you want.

       'presets' drop-down menu
         - Select a preset to load the play message into the edit box.

         '[default]' and '[mp3stuff]' presets
           - These are the primary and secondary default play messages.  The
             [mp3stuff] preset will remove colors 1 and 15 from the current
             color list when loaded.

       'remove' drop-down menu
         - Select a play message preset to remove.


     custom timed channel advertisement
     ----------------------------------
       - You can enter a channel advertisement to be sent to all channels in
         your 'play to' list (the edit box on the remote control, and in the
         mp3 selecting dialog).  This can use the following tags:
         <c> </c> <nick> <open slots> <used slots> <slots> <open queues>
         <used queues> <queues> <mp3count> <list count> <list size>

       start ad now, and on startup
         - When you turn this option on, your advertisement will be sent, and
           the timer will be started to send it again.  The timer will also be
           started each time you open mirc.

       minutes
         - The '+/-' buttons change the number of minutes for the timer.  You
           can click on one, then hold down the enter key to keep increasing
           or decreasing it. The minimum is 1 minute and the maximum is 60.

       'save as...' button
         - Saves the current play message to a preset with the name you want.

       'presets' drop-down menu
         - Select a preset to load the play message into the edit box.

         '[default]' and '[mp3stuff]' presets
           - These are the primary and secondary default advertisements.  The
             [mp3stuff] preset will remove colors 1 and 15 from the current
             color list when loaded.

       'remove' drop-down menu
         - Select a play message preset to remove.


     supported tags
     --------------
          <!nickmp3> - Inserts "!<your nick> <mp3>" into the message.  The
                       "!<your nick>" part will only show up if the mp3 is in
                       your specified mp3 directories, and only if you have
                       auto-send enabled.
               <mp3> - the filename of the mp3 being played.
          <mp3noext> - the filename without the .mp3 extension.
              <size> - file size
              <time> - length of the mp3
              <kbps> - kbps
               <khz> - khz
            <stereo> - mono / stereo / joint stereo
                 <c> - Inserts a random color if enabled.
                </c> - Switches to normal text color.
              <nick> - Inserts the nick specified in the last tab of the
                       options dialog. (nick used in list)
        <open slots> - number of open send slots
        <used slots> - number of send slots in use
             <slots> - total number of send slots
       <open queues> - number of open queues
       <used queues> - number of used queues
            <queues> - length of queue list
          <mp3count> - total number of mp3s in your directories
        <list count> - total number of mp3s in your list
         <list size> - total size of the mp3s in your list


   ------------------------------------------------------
    fourth tab of options dialog, labeled "file serving"
   ------------------------------------------------------

     file serving options
     --------------------

       auto-send files when they are requested
         - This will allows others to get mp3s from you by typing
           "!<yournick> <filename>" into a channel or query with you.
           It also allows others to get your mp3 list by typing "@<your nick>".
         - Example:  If your nick is "Bob", and you have an mp3 named
             "Good Song.mp3", people can type "!Bob Good Song.mp3" to
             get it from you.  To get your list, they can type "@Bob".

       number of send slots
         - This will limit the total number of sends you can have at the same
           time. If you have the maximum number of sends open, and someone
           requests an mp3 from you by typing "!<your nick> <file name>", the
           request will be placed in a file queue list, and it will be sent
           when enough files finish sending.  They can check their queue
           status by typing "@<your nick>-que", and remove their queued files
           by typing "@<your nick>-remove [file name]" (file name optional).

       max number of send slots per user
         - You can limit the number of files that can be sent to a user at the
           same time.

       length of queue list
         - Limits the length of the file queue list, as described above, under
           "number of send slots".  If the file queue list fills up, no further
           requests will be recorded.

       max number of queues per user
         - You can limit the number of files that a user can have in your file
           queue list.

       display script ad when auto-sending
         - Includes an ad in the notice that is sent when a file is requested.
           The ad contains the script name, the version number, and the website
           where it can be downloaded from.

       echo all messages that mp3stuff sends
         - You can choose to see the messages that mp3stuff sends or not.


     @locator/@find
     --------------

       respond to @locator/@find searches
         - If this is enabled, then people can type "@locator song name" or
           "@find song name" in a channel or query with you, and mp3stuff will
           send the person messages if it finds any matches to their search.
           Spaces will be replaced by "*"'s.  A "?" will match any one
           character, and a "*" will match zero or more characters.
         - Example:  If you have an mp3 named "Good Song.mp3", then all of
             the following will find it:  "@locator good", "@find s?ng",
             "@find oo ong", "@locator od?so", "@locator go*ng"

       note to send with @locator/@find results
         - If you have specified a note and an mp3 is found by a @locator/@find
           search, the note will be sent with the results.  You can use the
           following tags in the note:
             <c> </c> <nick> <open slots> <used slots> <slots> <open queues>
             <used queues> <queues> <mp3count> <list count> <list size>
           These tags are described above, in the 'public display' section.


   ----------------------------------------------------------------------------
    fifth tab of options dialog, labeled "mp3 list / directories / mp3 player"
   ----------------------------------------------------------------------------

     mp3 list
     --------

       'view list' button
         - This will open your current list, if you have made one.

       'update' button
         - This will make a list of your mp3s.  A minimized copy of mIRC
           will open, and that mIRC window will create the list.  It will
           close when the list is done.  The more organized your mp3s are
           in your directories, the more organized the list will be.

       use full info (takes longer)
         - Full info includes file size, length, kbps, khz, and mono/stereo.

       nick used in list
         - This nick will be the one that is shown with a "!" before each file
           name in the mp3 list.  The list shows "!<your nick> <file name>" for
           each file, for easy requesting.  This nick will also be used in the
           file name for the list.


     mp3 directories
     ---------------
       - The directories you set will be used to find mp3s when making mp3
         lists, when playing random mp3s, when other people play mp3s, and when
         people use @locator/@find/!nick file commands.  When a directory is
         set, all the sub-directories are included.

       'add a directory' button
         - Adds an mp3 directory to the list.

       'remove selected' button
         - Removes the selected mp3 directories from the list.


     mp3 player
     ----------
       - If the default setting does not work for you, then you need to set an
         mp3 player.  Winamp is recommended, but not required.  If a new window
         opens every time you play an mp3, you need to go to the options of the
         mp3 player and disable that feature.  If you are using Winamp, do this
         by clicking on  "options > preferences > options"  in Winamp, and make
         sure the option called "Allow multiple instances" is off.  Also, turn
         off the repeat option so the mp3s don't loop when finished.

       'mIRC' button
         - Uses mIRC's built-in mp3 player. (for mIRC 5.8+)

       'select' button
         - Lets you select an mp3 player.

       'default' button
         - Uses the default setting.



 =================
  playlist editor
 =================
   You can create a playlist and have mp3stuff play random mp3s from it.
   To open the editor, click on  "mp3stuff > more options > edit playlist"
   in the popup menu.  You can also use the 'edit playlist' button on the first
   tab of the options dialog to open the editor.

   dead files in playlist
     - If a file in the playlist no longer exists, mp3stuff will search for the
       file name in your mp3 directories, ignoring the path.  If a file with
       the same name is found, it will be updated in the playlist.

     playlist editor controls
     ------------------------

       add file
         - This opens the 'Select an mp3' dialog so you can pick mp3s to add.
           The dialog will re-open after you pick a file.  Click on the 'x' to
           stop adding files.

       add dir
         - Adds all mp3s in a directory.

       add wildcard
         - Adds all mp3s in your mp3 directories that contain a certain string.

       add m3u
         - Adds mp3s listed in an .m3u file to the playlist.

       remove selected
         - Removes the selected mp3s.

       remove dir
         - Removes all mp3s in a directory.

       remove wildcard
         - Removes all mp3s that contain a certain string.

       remove dead files
         - Removes all files that no longer exist.

       options
         - Opens the options dialog to the tab with playlist options on it.

       save copy
         - Saves a copy of the playlist to a file (.m3u).

       save & close
         - Closes the playlist editor and saves your changes.
           (This is the same as clicking on the 'x')

       use playlist as random mp3 source
         - Enables or disables playlist feature.



 ============
  /mp3search
 ============
   Type "/mp3search [search string]" to search for mp3s in your specified mp3
   directories.  You can also access /mp3search by clicking on can also be
   accessed by clicking on  "mp3stuff > more options > /mp3search"  in the
   popup.

   edit box
     - You can search again by typing in a search string in the editbox at the
       bottom of the mp3 search window.  Wildcards may be used in the search
       string.  A "?" will match any one character, and a "*" will match zero
       or more characters.  Spaces will be replaced with "*"'s.

   results
     - The results of the search are listed in the main part of the window.
     - Double-clicking on an mp3 in the results will open it, using your
       current settings for listening/playing.

   mp3 search right-click menu
     - The popup menu for the mp3 search window has some options in addition
       to the main mp3stuff popup menu.

     copy location
       - Copies the path and file name to the clipboard.

     open this mp3
       - This opens the selected mp3.  (Same as double clicking.)

     open a random mp3
       - This will open a random mp3 from the /mp3search results.

     enqueue by default
       - Same as in the main mp3stuff popup.

     edit mp3 directories
       - This opens the options dialog to the tab with mp3 directories.

     window on desktop
       - You can have the mp3 search window on the desktop if you want.



 ================
  other commands
 ================
   Playing mp3s through mp3stuff can also be done through the command line.
   Here are some of the commands available.  Parameters surrounded by []'s
   are optional.  For all [0|1]'s, a 0 means 'no', and a 1 means 'yes.'

     /mp3stuff lc
       Function:  Opens the mp3-selecting dialog & sets mode to 'listen.'

     /mp3stuff pc [#|nick]
       Function:  Opens the mp3-selecting dialog & sets mode to 'play to.'
         - Separate multiple channels or nicks by commas (no spaces).
         - Use "all" for all channels.

     /mp3stuff lr [0|1] [0|1]
       Function:  Opens a random mp3 in 'listening' mode.
         - The first [0|1] specifies continuous play.
         - The second [0|1] specifies a forced enqueue.
           - Forced enqueue turns continuous play on.

     /mp3stuff pr [#|nick] [0|1] [0|1]
       Function:  Opens a random mp3 in 'play to' mode.
         - Use %mp3stuffplayto for current channel/nick list.
         - Separate multiple channels or nicks by commas (no spaces).
         - Use "all" for all channels.
         - The first [0|1] specifies continuous play.
         - The second [0|1] specifies a forced enqueue.
           - Forced enqueue turns continuous play on.

     /mp3stuff adv
       Function:  Skips to next mp3 in play queue.

     /mp3stuff ad [#]
       Function:  Sends out your custom channel advertisement.
         - Separate multiple channels by commas (no spaces).
         - Use "all" for all channels.

     /mp3stuffc [0|1] [0|1] [x] [y]
       Function:  Opens the remote control dialog.
         - The first [0|1] specifies if you want listening controls only.
         - The second [0|1] specifies if you want setup options shown.
         - [x] and [y] are the position of the dialog.
           - Use -1 for default x or y.

     /mp3stuffp
       Function:  Opens the playlist editor.

     /mp3stuffo
       Function:  Opens the options dialog.

     /aboutmp3stuff
       Function:  Opens the 'about' dialog.

     /downloadmp3stuff
       Function:  Installs the newest version.

--------------------------------------------------------------------------------
